The Web Dashboard is configured through the dashboard.config file, a set of XSL Files, and a set of style sheets (CSS files). In most cases this file will be found in the root of the Web Dashboard application. The only deployment-specific configuration in the web.config file is an optional appSetting which can specify an alternative location for the dashboard.config file. If you want to use this behaviour, set the DashboardConfigLocation appSetting value to be the absolute path of your dashboard.config file.

The configuration file forms a tree of constructs, starting at the root element. The documentation for the rest of this section is reference documentation for each of the types of constructs you can use.

Default Configuration The dashboard.config file that ships with CruiseControl.NET will work with a default setup, i.e. one where you are using a build server on the same machine as the Web Dashboard and haven't changed any of the Remoting settings.

Monitoring Multiple Servers It's easy to use a single IIS running the Web Dashboard to monitor multiple CruiseControl.Net build servers. See the Servers Configuration Block.

Configuration elements

• Dashboard Configuration Block
  • Plugins Configuration Block
    • Build Log Build Plugin
    • Build Report Build Plugin
    • CCTray Download Plugin
    • Custom templates
    • Farm Report Farm Plugin
    • Latest Build Report Project Plugin
    • modificationHistoryProjectPlugin
    • Multiple XSL Report Build Plugin
    • Project Configurable Build Plugin
    • Project Report Project Plugin
    • Project Statistics Plugin
    • projectConfigurationServerPlugin
    • RSSFeedProjectPlugin
    • Server Information Server Plugin
    • Server Log Project Plugin
    • Server Log Server Plugin
    • Server Report Server Plugin
    • View All Builds Project Plugin
    • View Configuration Project Plugin
    • ViewServerQueue Server Plugin
    • XSL Report Build Plugin
    • XSL Report Project Plugin
  • Remote Services Configuration Block
    • Servers Configuration Block

Upgrading from previous versions There is no longer any project-specific configuration required to use the Web Dashboard. However, you should set the webURL element properly in your project's Build Server configuration to make sure CCTray and Email publishing work.